home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / SLRN0871.ZIP / KILL_FAQ < prev    next >
Encoding:
Text File  |  1996-03-27  |  8.0 KB  |  257 lines
  1. The purpose of this FAQ is to provide answers for commonly asked questions
  2. about slrn score files.  Some of the questions are based on a similar FAQ
  3. for the rn newsreader.
  4.  
  5. Questions:
  6.  
  7. 1. How do I set up slrn to read a score file?
  8. 2. What is the format of an slrn score file?
  9. 3. How do I assign a score to a specific subject, e.g., ``test'' messages?
  10. 4. How do I score postings from a specific person?
  11. 5. How do I score articles from a specific site?
  12. 6. How do I score followups?
  13. 7. How do I kill cross posts from a specific group?
  14. 8. How do I score all cross-posts?
  15. 9. I know how to kill posts from a specific person. How do I make it so I
  16.     read _only_ the posts from a specific person?
  17. 10. How do I score articles that have no references line but whose subject
  18.         line starts with ``Re:''
  19. 11. How do I score subject headers that contain only uppercase characters?
  20.  
  21. Answers:
  22.  
  23. ------------------------------
  24.  
  25. Subject: 1. How do I set up slrn to read a score file?
  26.  
  27.     In order for slrn to read a score file, it must know the name of the
  28.     score file.  This is specified by putting the appropriate line in your
  29.     .slrnrc file.  For example, if the name of the score file is `Score' and
  30.     it is located in the News subdirectory, then add the line:
  31.  
  32.         scorefile "News/Score"
  33.  
  34.     to your .slrnrc file.
  35.  
  36. ------------------------------
  37.  
  38. Subject: 2. What is the format of an slrn score file?
  39.  
  40.     The format is simple.  It consists sections that scores that are to be
  41.     applied to one or more newsgroups.  Each section must start with a line
  42.     that contains the name of the newsgroup, enclosed in square brackets,
  43.     for which the scores defined by that section apply.
  44.  
  45.     For example, a line of the form:
  46.  
  47.         [sci.physics.*]
  48.  
  49.     indicates the beginning of a section of scores for the sci.physics
  50.     hierarchy of newsgroups.
  51.  
  52.     Individual scores of a section start with the `Score' keyword.  It
  53.     indicates how many points are to be awarded to the article if it passes
  54.     the test defined by the score.  For example,
  55.  
  56.        Score: 100
  57.          Subject: neutrino
  58.  
  59.     defines a score of 100 points to an article if the subject contains the
  60.     word `neutrino'.
  61.  
  62.     It is also possible to score an article based on more than one header.
  63.     For example,
  64.  
  65.        Score: 1000
  66.          Subject: path integral
  67.      From: Richard Feynman
  68.  
  69.     gives an article a score of 1000 if the subject is about path integrals
  70.     and the author is ``Richard Feynman''.
  71.  
  72.     A score of -9999 is a special score.  If an article scores this value on
  73.     a given test, any other tests for the article will be skipped and the
  74.     article will be killed.
  75.  
  76.     If the first character of a score is `=', the article will given the
  77.     score and the rest of the tests will be skipped.  For example,
  78.  
  79.        [sci.physics.*]
  80.  
  81.        Score: =1000
  82.          From: @space.mit.edu
  83.  
  84.        Score: -9999
  85.          Xref: astrology
  86.  
  87.     defines two tests for the sci.physics hierarchy of newsgroups.  Since
  88.     the first score starts with the `=' character, any article that whose
  89.     author's email address contains `space.mit.edu' will be given 1000
  90.     points and the rest of the tests will be skipped.  The second test
  91.     assigns a score of -9999 to any article cross posted to an astrology
  92.     newsgroup.  Since the score defined by this test is -9999, the article
  93.     will be killed.  Together these two tests indicate that any article
  94.     cross posted to an astrology newsgroup is killed except if the author is
  95.     from space.mit.edu in which case the article is awarded 1000 points.
  96.  
  97.     The `~' character may used used as a NOT operator.  For example, the
  98.     previous score can (almost) be written:
  99.  
  100.       [sci.physics.*]
  101.  
  102.       Score: -9999
  103.        ~From: @space.mit.edu
  104.         Xref: astrology
  105.  
  106.     This simply says to kill any article that was cross posted to an
  107.     astrology group UNLESS the author is from space.mit.edu.
  108.  
  109.     Finally the ``Score'' keyword can be followed by 2 colons to indicate
  110.     that any the score is awarded to the article if any of the tests defined
  111.     by the score are passed.  For example,
  112.  
  113.        Score:: 1000
  114.          Subject: neutrino
  115.      Subject: fermion
  116.  
  117.     assigns a score of 1000 to an article if its subject line contains
  118.     either neutrino or photon.
  119.  
  120. ------------------------------
  121.  
  122. Subject: 3. How do I assign a score to a specific subject, e.g., ``test'' messages?
  123.  
  124.      Score: -9999
  125.      Subject: test
  126.  
  127. ------------------------------
  128.  
  129. Subject: 4. How do I score postings from a specific person?
  130.  
  131.      Score: -9999
  132.      From: name@who\.knows\.where
  133.  
  134.    assigns a score of -9999 to the person name@who.knows.where.
  135.  
  136. ------------------------------
  137.  
  138. Subject: 5. How do I score articles from a specific site?
  139.  
  140.      Score: -9999
  141.      From: @who\.knows\.where
  142.  
  143.    will give a score of -9999 to an From line that contains
  144.    `@who.knows.where'.
  145.  
  146. ------------------------------
  147.  
  148. Subject: 6. How do I score followups?
  149.  
  150.    Assume a followup either contains a subject starting with `Re:' or has a
  151.    references header.  To assign a score of -9999 to such an article use:
  152.  
  153.       Score:: -9999
  154.       Subject: ^Re:
  155.       References: .
  156.  
  157.    Note the use of the double colon following the score keyword.  This
  158.    indicates that the score is an OR type expression.  This means that the
  159.    above score will pick out articles with EITHER subjects that begin with
  160.    `Re:' OR have a references line.
  161.  
  162.    To score articles with BOTH subjects with `Re:' AND a references headers,
  163.    use the single colon form:
  164.  
  165.       Score: -9999
  166.       Subject: ^Re:
  167.       References: .
  168.  
  169.    Single colon forms are AND expressions.
  170.  
  171. ------------------------------
  172.  
  173. Subject: 7. How do I kill cross posts from a specific group?
  174.  
  175.    You have two choices: either use the `Xref' header or the `Newsgroups'
  176.    header.   It is best to avoid the `Newsgroups' header if possible, that
  177.    is, try to use the Xref header.
  178.  
  179.    Assume that you want to score any article that was cross-posted to an
  180.    ``astrology'' newsgroup.  Then use one of the following forms:
  181.  
  182.        Score: -9999
  183.        Xref: astrology
  184.  
  185.        Score: -9999
  186.        Newsgroups: astrology
  187.  
  188.    Again, try to avoid using the last form if possible.
  189.  
  190. ------------------------------
  191.  
  192. Subject: 8. How do I score all cross-posts?
  193.  
  194.    Like the previous answer you have two choices: to use the Xref header
  195.    (preferred) or the Newsgroups header.  The first choice uses the fact
  196.    that a cross-posted article will have two colons in the Xref header
  197.    field.  So, use a score of the form:
  198.  
  199.       Score: -9999
  200.       Xref: :.*:
  201.  
  202.    If you do not have the option of using the Xref header, use:
  203.  
  204.      Score: -9999
  205.      Newsgroups: ,
  206.  
  207. ------------------------------
  208.  
  209. Subject: 9. I know how to kill posts from a specific person. How do I make it so I
  210.     read _only_ the posts from a specific person?
  211.  
  212.    The answer is simple: kill posts by everyone else.  Assume that you want
  213.    to only read posts by someone whose from line contains: someone@i.like.
  214.    Then use a score of the form:
  215.  
  216.       Score: -9999
  217.       ~From: someone@i\.like
  218.  
  219.    Note the use of the NOT indicator (~).
  220.  
  221. Subject: 10. How do I score articles that have no references line but whose
  222.          subject line starts with ``Re:''
  223.  
  224.    Define a score based on the references header and the subject headers,
  225.    e.g., 
  226.    
  227.       Score: -9999
  228.       ~References: .
  229.       Subject: ^Re: 
  230.       
  231.    Here the the references line simply says that the article must NOT have a
  232.    references header.  The subject header uses a regular expressions that
  233.    says ``Re:'' must occur at the beginning of the subject.  This will match
  234.    the strings "Re:", "re:", "rE:", and "RE:".  To match only "Re:", use the
  235.    regular expression
  236.    
  237.       Subject: ^\cRe:
  238.       
  239.    Here \c turns on case-sensitivity.  To turn it off, use \C.
  240.    
  241. 11. How do I score subject headers that contain only uppercase characters?
  242.  
  243.    Use something like:
  244.    
  245.       Score: -9999
  246.         ~Subject: \c[a-z]
  247.     
  248.    This will assign a score of -9999 to any article whose subject header
  249.    does NOT contain a lowercase character.  To also kill followups to such
  250.    articles use:
  251.    
  252.       Score:: -9999
  253.         ~Subject: \c[a-z]
  254.         ~Subject: ^Re: \c.*[a-z]
  255.    
  256.       
  257.